home *** CD-ROM | disk | FTP | other *** search
/ Language/OS - Multiplatform Resource Library / LANGUAGE OS.iso / a_utils / _archvrs / unix / zoo21src.lha / zoo / wildmat.man < prev    next >
Text File  |  1992-11-20  |  2KB  |  67 lines
  1. WILDMAT(3)             C LIBRARY FUNCTIONS             WILDMAT(3)
  2.  
  3. NAME
  4.      wildmat - perform shell-style wildcard matching
  5.  
  6. SYNOPSIS
  7.      int
  8.      wildmat(text, pattern)
  9.          char       *text;
  10.          char       *pattern;
  11.  
  12. DESCRIPTION
  13.      Wildmat compares the text against the  pattern  and  returns
  14.      non-zero  if  the  pattern matches the text.  The pattern is
  15.      interpreted similar to shell filename wildcards, and not  as
  16.      a  full  regular  expression  such  as  those handled by the
  17.      grep(1) family of programs or the regex(3) or regexp(3)  set
  18.      of routines.
  19.  
  20.      The pattern is interpreted according to the following rules:
  21.  
  22.      \x   Turns off the special  meaning  of  x  and  matches  it
  23.           directly; this is used mostly before a question mark or
  24.           asterisk, and is not valid inside square brackets.
  25.  
  26.      ?    Matches any single character.
  27.  
  28.      *    Matches any sequence of zero or more characters.
  29.  
  30.      [x...y]
  31.           Matches any  single  character  specified  by  the  set
  32.           x...y,  where  any  character  other than minus sign or
  33.           close bracket may appear in the set.  A minus sign  may
  34.           be  used  to  indicate a range of characters.  That is,
  35.           [0-5abc] is a shorthand for [012345abc].  More than one
  36.           range  may appear inside a character set; [0-9a-zA-Z._]
  37.           matches almost all of the legal characters for  a  host
  38.           name.
  39.  
  40.      [^x...y]
  41.           This matches any character not in the set x...y,  which
  42.           is interpreted as described above.
  43.  
  44. BUGS
  45.      There is no way to specify  a  minus  sign  in  a  character
  46.      range.
  47.  
  48. HISTORY
  49.      Written by Rich $alz <rsalz@bbn.com> in 1986, and posted  to
  50.      Usenet   several   times   since   then,   most  notably  in
  51.      comp.sources.misc in March, 1991.
  52.  
  53.      Lars Mathiesen <thorinn@diku.dk> enhanced the multi-asterisk
  54.      failure mode in early 1991.
  55.  
  56.  
  57.  
  58. WILDMAT(3)             C LIBRARY FUNCTIONS             WILDMAT(3)
  59.  
  60.      Rich and Lars increased the efficiency of star patterns  and
  61.      reposted it to comp.sources.misc in April, 1991.
  62.  
  63.      This is revision 1.4, dated 91/03/25.
  64.  
  65. SEE ALSO
  66.      grep(1), regex(3), regexp(3).
  67.